home *** CD-ROM | disk | FTP | other *** search
/ Precision Software Appli…tions Silver Collection 1 / Precision Software Applications Silver Collection Volume One (PSM) (1993).iso / windows / games / splite.exe / DOC / NEWFEAT.DOC next >
Text File  |  1991-11-26  |  13KB  |  265 lines
  1.                      S H O W   P A R T N E R   L I T E            Version 3.7a
  2.                              FILE NEWFEAT.DOC                      26 Nov 1991
  3.  
  4.                         New Features in Version 3.7a
  5.                       ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  6.     Copyright 1985-1991 by Brightbill-Roberts & Co.  All rights reserved.
  7.  
  8.  
  9.               ┌─────────┐
  10.         ┌─────┴───┐     │               (R)
  11.       ──│         │o    │──────────────────
  12.         │   ┌─────┴╨──┐ │  Association of
  13.         │   │         │─┘  Shareware
  14.         └───│    o    │    Professionals
  15.       ──────│    ║    │────────────────────
  16.             └────╨────┘    MEMBER
  17.                      
  18.  
  19. ┌──────────────────────────────────────────────────────────────────────────┐
  20. │ Brightbill-Roberts Tech Office    │ Phone: 800-362-0777 or 303-697-1411  │
  21. │     21969 Plateau Circle          │           FAX: 303-697─1445          │
  22. │      Morrison, CO 80465           │  Compuserve 75300,363 or GO PCVENC   │
  23. └──────────────────────────────────────────────────────────────────────────┘
  24.  
  25.  
  26. SHOW PARTNER LITE 3.7a
  27.  
  28. The previous major version of Show Partner Lite was called Show Partner 3.0.
  29. We have added LITE to the name to lessen any confusion with our high end
  30. product, Show Partner F/X. All Show Partner "family" products share much
  31. of the same software infrastructure and share the same version number if
  32. the have equivalent technology. This version is 3.7a and represents our
  33. most current (to date) technology.
  34.  
  35. This version has many improvements over Show Partner 3.0. Some of these
  36. changes have not yet been incorporated into the documentation. This file
  37. will describe all the new features not otherwise covered in the SPLITE.DOC
  38. file.
  39.  
  40. _____________________________________________________________________________
  41. VGA PALETTE DEPTH IN NON-256 COLOR MODES (SED, SLED, and SHOW)
  42.  
  43. By default all non-256 color pictures are displayed with EGA palette depth
  44. (64 colors) rather than VGA palette depth (256,000 colors). This is the
  45. default so that shows written in 2, 4 or 16 colors will look the same
  46. regardless of whether they are shown on EGA or VGA systems. If you know
  47. in advance that your audience will have VGA capability you can enable VGA
  48. palette depth by adding a '/x' switch to the command line of SED, SLED and
  49. SHOW.
  50.  
  51.       Examples:  sed /x
  52.                  show script /x
  53.  
  54. NOTE: the graphics editor (GED.EXE) does not support VGA palette depth in
  55. 16 color modes. You should avoid editing pictures with VGA palette depth
  56. if you wish to retain their full palette.
  57.  
  58. _____________________________________________________________________________
  59. CHANGES TO CAPTURE.EXE
  60.  
  61. CAPTURE now uses a new and improved strategy for converting text mode
  62. screens to graphics mode. If you have EGA or VGA capability, CAPTURE will
  63. convert (at your command) the text mode screen to 640x350x16 color mode.
  64. It will preserve all color attribute information in the process.
  65.  
  66. We have added some new "command line" options for using the CAPTURE program.
  67. You can still use CAPTURE exactly as described in the documentation. But in
  68. some capturing situations, the new methods may prove valuable.
  69.  
  70.          CAPTURE /Ffilenm
  71.  
  72. The "/F" switch allows you a shotgun approach to screen capturing. In the
  73. above example, every time you press CAPTURE's trigger keys a file will be
  74. saved to disk with no further intervention on your part. The files will be
  75. named (using the above example) as filenm01.GX2, filenm02.GX2, etc.
  76.  
  77.          CAPTURE /Gfilenm
  78.  
  79. This is the same as the /F switch except that any text mode screens are
  80. immediately converted to graphics mode.
  81.  
  82.          CAPTURE /U
  83.  
  84. This switch removes a CAPTURE from memory, freeing up space for use by
  85. other programs. This is not always possible, however, and CAPTURE will
  86. generate an error message if some other program has made it impossible
  87. for it to remove itself.
  88.  
  89.          CAPTURE /K
  90.  
  91. This switch overides the default trigger key combination of CTRL-ALT-MINUS.
  92. If you use this switch, CAPTURE will prompt you to press and hold the three
  93. keys that you wish to use as the new trigger.
  94.  
  95.          CAPTURE /P
  96.  
  97. If you desire to use the simple trigger, SHF-PrtSc, use this switch. The
  98. other trigger key combination will still function as well.
  99.  
  100.  
  101. _____________________________________________________________________________
  102. CHANGES TO THE SCRIPT EDITOR : SED.EXE
  103.  
  104. MOUSE MENUS -- The MENU and PAGE effects have been modified to allow the
  105. implementation of point-and-shoot style mouse menus. These types of menus
  106. have visual "buttons" which are pressed by moving the mouse cursor into
  107. a hot area and pressing a button. To use the MENU effect in keyboard mode
  108. only (the way it worked in previous versions) simply leave the DIRECTION
  109. field of the MENU effect "Keys" (the default). To implement a mouse menu
  110. set the DIRECTION FIELD to "Mouse" or "Both". The other fields of the MENU
  111. effect have the following meanings with a mouse menu:
  112.  
  113.    Picture/Comment : This field contains a list of valid hot keys terminated
  114.                      by a dollar sign ($). If the field is blank, all keys
  115.                      are considered valid.
  116.  
  117.    Location/Size   : This is the extent of the "playing field" around which
  118.                      the mouse cursor may roam. Usually you will way to leave
  119.                      this FULL PICTURE so that the mouse can be moved around
  120.                      the entire screen.
  121.  
  122.    Target          : This field describes the starting location of the mouse
  123.                      cursor. To position the mouse in the middle of a
  124.                      640x480 screen, for example, put "320,240" here.
  125.  
  126.    Time            : This is the amount of time to wait for a "menu event"
  127.                      before giving up and proceeding with the script lines
  128.                      following the MENU effect. A time of "Key" will wait
  129.                      forever for a menu event.
  130.  
  131. Menu events are described by PAGE effects. Whenever the conditions described
  132. by a PAGE effect are met, the lines following the PAGE effect are performed.
  133. The fields of the PAGE effect have the following meaning during a mouse
  134. menu:
  135.  
  136.    Picture/Comment : The 'hot key' if any is listed here. If the viewer
  137.                      presses the hot key, the mouse status is ignored and
  138.                      the PAGE condition is considered satisfied.
  139.  
  140.    Direction       : This specifies the mouse button status and can be set
  141.                      to None, Left, Right or Both.
  142.  
  143.    Location/Size   : This describes the hot area (i.e. the "button" area)
  144.                      on the screen for this menu option.
  145.  
  146. The easiest way to develop a mouse menu is to create and clip all the
  147. necessary PAGE effects in the lines directly after the menu effect before
  148. moving them to their respective places in the script. This will insure that
  149. during the clipping of the PAGE effects the menu screen will be visible.
  150.  
  151.                ------------------------------------------
  152.  
  153. COLOR NUMBER CLIP -- Some of the "Special" effects manipulate the color
  154. palette and require color numbers in the PICTURE/COMMENT field. Previous
  155. versions required you to know these number (or figure it out) without any
  156. assistance. If you select one of the color palette effects PALSHF, CLRSHF,
  157. or CLRCHG in the effect field, clipping that script row will allow you to
  158. get a color number simply by pointing the cursor at it on the screen.
  159.  
  160. NOTE: the screen at that point in the script must have pixels of the
  161. color to point at.
  162.  
  163. To use the color number clip:
  164.  
  165.      1.  Select PALSHF, CLRSHF or CLRCHG for the EFFECT field.
  166.      2.  Move the cursor to the LOCATION field of the same row and
  167.          press INS (or left mouse button).
  168.      3.  Move the crosshair to a pixel whose color number you want
  169.          to know.
  170.      4.  Press INS (left button).
  171.  
  172. The PICTURE/COMMENT field will contain the color number of the pixel you
  173. pointed at. You can add additional (comma separated) color numbers to the
  174. field by simply "clipping" the row again.
  175.  
  176.                ------------------------------------------
  177.  
  178. NEW PALSHF EFFECT OPTIONS -- The PALSHF effect now works in 4 different
  179. ways depending upon how you set up the PICTURE/COMMENT field.
  180.  
  181.      OPTION 1 : This is the old way that PALSHF used to work. A single
  182.                 number in the PICTURE/COMMENT field gives the number
  183.                 of times the entire palette is to be shifted. This method
  184.                 works with all graphics modes except Hercules.
  185.  
  186.      OPTION 2 : This 3-number syntax allows you to select a subset of the
  187.                 full palette to be shifted. The syntax is [start color],
  188.                 [end color],[number of shifts]. For example, if the
  189.                 PICTURE/COMMENT field contains "2,5,20", colors 2 through
  190.                 5 (inclusive) will be shifted 20 times.
  191.  
  192.      OPTION 3 : The 2-number syntax specifies a BACKGROUND color shift. A
  193.                 background shift means that the palette keeps shifting even
  194.                 after the effect has ended. Thus you can have a palette
  195.                 shift occuring while some other screen effect is being
  196.                 performed. The two numbers describe the starting and
  197.                 ending color numbers that are to participate in the shift.
  198.  
  199.      OPTION 4 : A blank PICTURE/COMMENT field with the PALSHF effect simply
  200.                 turns off any BACKGROUND palette shift.
  201.  
  202. Options 2, 3 and 4 require EGA or VGA capability and a screen mode with at
  203. least 16 colors.
  204.  
  205.  
  206. _____________________________________________________________________________
  207. CHANGES TO THE RUNTIME MODULE : SHOW.EXE
  208.  
  209. The SHOW program will now allow you to view and browse any number of GX2
  210. files without first creating a script. For example :
  211.  
  212.         SHOW Z*.GX2
  213.  
  214. The above command will automatically generate a slide show using every
  215. GX2 file in the current directory that starts with the letter Z. If the
  216. file name is unambiguous (e.g. does not have any wild card characters)
  217. then the single GX2 file is displayed and, upon a key press, SHOW will
  218. end. When multiple files are displayed, pressing ESC at any picture will
  219. send you to a menu listing all the GX2 files in the slide show.
  220.  
  221.  
  222. _____________________________________________________________________________
  223. NEW PROGRAM : WIN3CAP
  224.  
  225. This program and its associated library, BRC3LIB.DLL, are used for capturing
  226. the Windows 3 desktop and saving it to a GX2 file. When run, WIN3CAP displays
  227. an "about" box describing itself and offering an "OK" button. Clicking this
  228. button will cause WIN3CAP to minimize itself and wait for your press of the
  229. trigger key combination. Upon pressing WIN3CAP's trigger key combination,
  230. CTRL-ALT-MINUS, you are presented with a dialog box for the entry of the file
  231. name. Pressing the OK button causes the GX2 file to be created.
  232.  
  233. The WIN3CAP can only be used when Windows has been setup to operate in a
  234. screen mode that Show Partner Lite supports. Thus if you have a super VGA
  235. driver installed you will have to revert to the generic VGA driver in order
  236. to use WIN3CAP.
  237.  
  238. _____________________________________________________________________________
  239. NEW GX1 and PCX CONVERSION UTILITIES
  240.  
  241. We have included three utilities for converting between the GX2 and PCX
  242. file formats and for upgrading old 3.0 pictures (*.GX1 files). PCXGX2.EXE
  243. converts PCX files to GX2 and GX2PCX.EXE does the reverse. GX1GX2.EXE
  244. upgrades pictures from Show Partner's old GX1 format. All of these 
  245. utilities are simple command line utilities that take a file name as a
  246. parameter. For example:
  247.  
  248.        PCXGX2 rosebud.pcx
  249.  
  250. The above example creates a rosebud.GX2 from a rosebud.PCX file. You can
  251. also use wildcards in the file name if you desire:
  252.  
  253.        PCXGX2 z*.pcx
  254.  
  255. This command will create a new GX2 file for every PCX file in the current
  256. directory if the file name begins with the letter Z.
  257.  
  258. NOTE: the PCXGX2 utility faithfully converts ANY PCX file to GX2 format,
  259. even if it has resolution or color capability that is not supported by the
  260. other programs of Show Partner Lite. To get a GX2 file that is usable
  261. by SP-Lite you must make sure that the PCX file is in an IBM standard mode.
  262. Thus, some PCX's created from a Window's program (when Window's is in a
  263. very high resolution setup) and some art from Scanner programs may need to
  264. be converted to a standard VGA resolution before being converted to GX2.
  265.